Outline MCP 서버
Outline MCP 서버
Outline MCP 서버는 AI 어시스턴트가 Outline 지식 베이스와 상호 작용할 수 있도록 하는 Model Context Protocol(MCP) 서버입니다. 이 서버를 통해 문서 검색, 읽기, 생성 및 관리, 컬렉션 액세스, 댓글 추가, 문서 백링크 관리 등의 기능을 수행할 수 있습니다.
특징
- 문서 검색: Outline 지식 베이스 내에서 문서를 검색합니다.
- 문서 읽기: 특정 문서의 내용을 검색하고 읽습니다.
- 문서 생성 및 편집: 새 문서를 생성하고 기존 문서를 업데이트합니다.
- 컬렉션 관리: 문서 컬렉션을 탐색하고 관리합니다.
- 댓글 관리: 문서에 댓글을 추가하고 관리합니다.
- 백링크 관리: 문서 간의 백링크를 관리합니다.
- 문서 구조화: 계층적 지식 베이스 구조를 활용합니다.
- 메타데이터 처리: 문서 메타데이터를 활용하여 검색 및 구성을 개선합니다.
API
리소스
Outline MCP 서버는 다음과 같은 리소스 유형을 제공합니다:
- Documents: Outline 지식 베이스의 문서
- Collections: 문서 컬렉션
- Comments: 문서에 대한 댓글
- Backlinks: 문서 간의 연결 관계
도구
문서 관리 도구
search_documents
문서를 검색합니다.
- 입력:
- query: 검색 쿼리
- collection_id: (선택 사항) 특정 컬렉션 내에서만 검색
- limit: (선택 사항) 반환할 최대 결과 수
get_document
특정 문서를 가져옵니다.
- 입력:
- document_id: 가져올 문서의 ID
create_document
새 문서를 생성합니다.
- 입력:
- title: 문서 제목
- collection_id: 문서가 속할 컬렉션 ID
- text: 문서 내용
- parent_document_id: (선택 사항) 부모 문서 ID
update_document
기존 문서를 업데이트합니다.
- 입력:
- document_id: 업데이트할 문서 ID
- title: (선택 사항) 새 문서 제목
- text: (선택 사항) 새 문서 내용
- publish: (선택 사항) 출판 여부
delete_document
문서를 삭제합니다.
- 입력:
- document_id: 삭제할 문서 ID
- permanent: (선택 사항) 영구 삭제 여부
컬렉션 관리 도구
list_collections
사용 가능한 컬렉션을 나열합니다.
- 입력:
- limit: (선택 사항) 반환할 최대 컬렉션 수
get_collection
특정 컬렉션의 세부 정보를 가져옵니다.
- 입력:
- collection_id: 컬렉션 ID
list_documents_in_collection
컬렉션 내의 모든 문서를 나열합니다.
- 입력:
- collection_id: 컬렉션 ID
- limit: (선택 사항) 반환할 최대 문서 수
댓글 관리 도구
add_comment
문서에 댓글을 추가합니다.
- 입력:
- document_id: 문서 ID
- text: 댓글 내용
list_comments
문서의 댓글을 나열합니다.
- 입력:
- document_id: 문서 ID
백링크 관리 도구
get_backlinks
문서에 연결된 백링크를 가져옵니다.
- 입력:
- document_id: 문서 ID
사용 방법
Outline MCP 서버를 사용하려면 다음 단계를 따르세요:
- Outline API 설정:
- Outline 인스턴스에서 API 토큰을 생성합니다.
-
API 엔드포인트 URL을 기록해 둡니다.
-
MCP 서버 설치 및 구성:
{ "mcpServers": { "outline": { "command": "npx", "args": ["-y", "outline-mcp-server"], "env": { "OUTLINE_API_TOKEN": "your_api_token", "OUTLINE_URL": "https://your-outline-instance.example.com" } } } } -
Claude Desktop를 다시 시작하여 설정을 적용합니다.
환경 변수
- OUTLINE_API_TOKEN (필수): Outline API 토큰
- OUTLINE_URL (필수): Outline 인스턴스의 URL
- API_TIMEOUT (선택 사항): API 요청 시간 초과(ms) (기본값: 10000)
- MAX_RESULTS (선택 사항): 검색 결과의 기본 최대 개수 (기본값: 10)
보안 고려 사항
Outline MCP 서버를 사용할 때 다음 보안 모범 사례를 염두에 두세요:
- API 토큰 보호: Outline API 토큰은 전체 지식 베이스에 대한 액세스 권한을 제공할 수 있으므로 안전하게 보관하세요.
- 최소 권한: 가능한 경우 읽기 전용 API 토큰을 사용하여 민감한 작업을 방지하세요.
- 데이터 유출 방지: 민감한 정보가 포함된 문서에 액세스할 때는 주의하세요.
문제 해결
- 인증 오류: API 토큰이 올바른지, 만료되지 않았는지 확인하세요.
- URL 오류: Outline 인스턴스의 URL이 정확한지 확인하세요.
- 접근 권한 문제: API 토큰에 필요한 모든 권한이 있는지 확인하세요.
사용 사례
Outline MCP 서버는 다음과 같은 상황에서 특히 유용합니다:
- 팀 지식 베이스 통합: 팀의 Outline 지식 베이스를 AI 워크플로우에 통합합니다.
- 문서 자동화: AI를 사용하여 문서 생성 및 업데이트를 자동화합니다.
- 지식 탐색: AI를 통해 방대한 문서 컬렉션을 빠르게 검색하고 탐색합니다.
- 내부 도구 연결: 내부 도구와 문서를 연결하여 통합된 작업 환경을 구축합니다.